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i STRUCDEF == DECLARATION FILE FOR DATA STRUCTURE DEFINITION 
AND ACCESS MACROS USED IN THE VAX DEBUGGER 


! 
| Version: *v04-000' 


SSSR E SECIS SSE T ITT TTT TTT rrr crit rc etic titi it rir r titi iti it titi i tit it itiiti.i tT 
'® 


ie COPYRIGHT (c) 1978, 1980, 1982, 1984 BY 
is DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS. 
ie ALL RIGHTS RESERVED. 


® 
x 
® 
® 
® 
® 
is THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 
ie ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 
iw INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER 
ie COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY * 
it OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY * 
is TRANSFERRED. * 
® 
® 
® 
® 
® 
® 
5 
® 
® 
® 


!® THE INFORMATION IN THIS SOFTWARE IS SU 
't AND SHOULD NOT BE CONSTRUED AS A C 
!t CORPORATION. 


BJECT TO CHANGE WITHOUT NOTICE 
OMMITMENT BY DIGITAL EQUIPMENT 


'® DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
:* SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 


Lee RRR RARER AREER AAA RARER AAAS 


i WRITTEN BY 
: Bert Beander August, 1981. 


' 

4 

1 

' 

: 

! MODULE FUNCTION: 
: This REQUIRE file contains all macros used in Seren and accessing 
; data structures (BLISS BLOCKs) in the VAX Debugger. These symbolic 
names should always be used in CLISS Field-References. 


V4.0=742 
:CTRACE.SRCISTRUCDEF .REQ; ie 


18-50-1984 33:98 G, | “SNS E BAS eS cPRaLE Sacigreucverneasse” «28 


DATA STRUCTURE DEFINITION AND ACCESS 


The following macros must be used in defining field names for ott data 
structures in the penuaser. soete macros supply he position, size, and 
5 grrorsens ‘en values when used in FIELD declarations for BLOCK and 
BLOCKVECTOR data structures. The various generic forms (as specified by 
the letters in the names) are as follows: 


A Materialized address 

L ongwor 

W ero-extended word 

8 ero-extended pyte 

v ero-extended bit fieid 
Sign-extended word 

SB Sign-extended pyse 

SV Sign-extended bit field 


The “‘A'’ form should be used whenever the field being defined is such 
that only the address of the field may be materialized in a structure 
reference; that is, fetch and store cperations on the field are not 
valid. An example of such a field is an ASCII string. 


Each of the ‘'V'’ and ‘‘SV"’ forms take one or two parameters. The first 

parameter is the bit position within the engrere (or byte) ang the 

second is the field size in bits. The second parameter is opt grey: 
f omitted, it defaults to 1. Thus V_(5) means bit 5 while V_(5,3) 

means the $-bit field starting at bit 5 and ending at bit 7. Bit 

pees trans are counted from the low-order (least significant) end of the 
ongword, starting at zero. 


Oo 


The following data structure picture shows the locations of the various 
fields that can be specified. Note how the bit positions are numbered 
along the top of the illustration. 


REDOSSCSESCESESSCSOSELS ESTOS TER 


tree ewe nen een we me mere nee Sew swe ee me eS SO Ce Oe we ee eee $ 


+ tee . 


S:9 L H 
De en es + 
1 i Wil i wO_ H 
teowcooee Pere wn t Sew www www www w wn toweoeeoorooce ee + | 
4 B3_ 1_ B0_ 
$ ewww mmww se ww wen} cower wes ew eww nt coc c ewes ee ecwn} ooceoenesceees= + 
ee¢ 
MACRO 
ba = 0, 0, OF, ! Address of a longword 
A0_ = 0, QO, i, ! Address of byte 
Al_ = 8, QO, i, ! Address of byte 
A2_ = 16, 0, i, ! Address of byte 2 
| 
| 


1 
1$-seo-1984 33:98 et MESS BASESr Haake: Sac i¢raucver neass™” (2s 


COMMAND QUALIFIERS 
BLISS/LIBRARY=L1IB$:STRUCDEF .L32/LIST=LIS$:STRUCDEF .LIS SRC$:STRUCDEF .REQ 
; Run Time: 8 : \.¢ 
; Elapsed Time: 3 ‘° 
Lines/CPU Min: g 


; Lexemes/CPU-Min: 28 
; Memory Used: 12 pages 


; } A3_ = 24, 0, 04%, ! Address of byte 3 : 
i; 01 Lo = Q, ; i. ! Longword : 
3 1 Ww. = Q, . ' Word, zero-extended ; 
: ! ? B. = 0, a : Byte, zero-extended é 
: 1 wO_ = 1 i, ! Word 0 zero-extended | ; 
: ; wi, = 18: 18: : i, ! Word 1 zero-extended | ‘ 
; 19 50_ = Q, 8, i, ' Byte 0 zero-extended ; 
3 1 Bi ® 8.- Be i, ' Byte 1 zero-extended ; 
3 11 B¢- = « Be i. ! Byte 2 zero-extended ; 
: 1% BS_ = 24, 8, ‘ ! Byte 3 zero-extended : 
; 13 6 V_(P,S) = P, ZIF ZNULL(S) ZTHEN 1 ZELSE S 2F1, 0 %, ! Unsigned bit field ; 
; 118 vO_(P,S) = P ZIF ZNULL(S) ZTHEN 1 ZELSE S$ XFI, O 8. ! Bits in BO. ; 
>) (011 Vi-(P,S) = (P48), SIF ZNULL(S) BTHEN 1 ZELSE S$ FI. , | Bits in B1- ; 
; 118 ver (P.$) = (P+165, XIF XNULL(S) ZTHEN 1 ZELSE $ RFI. 0%. | Bits in B2~ 3 
3 Bt VS_(P,S) = (P#24), ZIF ZNULL(S) ZTHEN 1 ZELSE S 2FI, %, | Bits in B3_ ; 
: 121 Swe = 0. 1. 1%, ' Word, sign-extended : 
3 : § $B_ = 0, 8 14%, ! Byte, sign-extended : 
: 1¢4 SwO_ 2 ©, 1%. 1 £. ! Word 0 sign-extended ; 
3 \¢? Swi_ = 16, 16, 1%, ! Word 1 sign-extended ; 
; 1 6 $B0_ = QO, sD Be ! Byte 9 sign-extended : 
3 1 3 $B1- = 8 8 1%, ! Byte 1 sign-extended 3 
3 1 SB2_ = 16, 8, 1%, ! Byte ; sign-extended F 
; : ? $B3- = 24, 8 1%, ! Byte 3 sign-extended ; 
F i é SV_(P,S)= P, ZIF SNULL(S) STHEN 1 BELSE S XFI, 1%, ! Signed bit field : 
0134 Sv0_(P,$) = P MIF XNULL(S) BTHEN 1 XELSE S$ XFI, 1%. ! Bits in BO_ ; 
3 135 SV1_(P,S) = (P+8) ZIF ZNULL(S) XTHEN 1 ZELSE S$ RFI, 1%, | Bits in B1_ é 
3 1 § SV2_(P,S) = (P+165, ZIF ZNULL(S) ZTHEN 1 ZELSE S AFI, 1%, ! Bits in B2_ 3 
; ; H ; SV35_(P,S) = (P+#24), ZIF ZNULL(S) ZTHEN 1 ZELSE S 2FI, 1 2; | Bits in B3_ : 
: 0139 ; 
; 0140 ' END OF STRUCDEF.REQ : 


1 
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; Library Precompilation Complete 
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